Add/improve long descriptions.

2004-12-15  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkcelleditable.sgml:
	* gtk/tmpl/gtkcellview.sgml:
	* gtk/tmpl/gtktreeviewcolumn.sgml:
	* gtk/tmpl/gtktreeview.sgml:
	* gtk/tmpl/gtktreesortable.sgml: Add/improve long
	descriptions.

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 7b7458760acbaee155abf31523c9ccebc9b0b94f..e8b63c1d86b3c4c887a07cd2080044675936093e 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,6 +1,18 @@
+2004-12-15  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/tmpl/gtkcelleditable.sgml: 
+       * gtk/tmpl/gtkcellview.sgml: 
+       * gtk/tmpl/gtktreeviewcolumn.sgml: 
+       * gtk/tmpl/gtktreeview.sgml: 
+       * gtk/tmpl/gtktreesortable.sgml: Add/improve long
+       descriptions.
+
+       * gtk/glossary.xml: Remove a dangling link.
+
 2004-12-14  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtk-sections.txt: Add new iconview methods.
+       Remove gtk_cell_view_set_value[s] for now.
 
 2004-12-13  Matthias Clasen  <mclasen@redhat.com>
 

diff --git a/docs/reference/gtk/tmpl/gtkcelleditable.sgml b/docs/reference/gtk/tmpl/gtkcelleditable.sgml
index d4f0aa5d09e7f89c2975459d47bcdf6d708656d8..c4df9822c04100504b7b1ffc42883c2b0e99095c 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkcelleditable.sgml
+++ b/docs/reference/gtk/tmpl/gtkcelleditable.sgml
@@ -6,7 +6,8 @@ Interface for widgets which can are used for editing cells
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+The #GtkCellEditable interface must be implemented for widgets
+to be usable when editing the contents of a #GtkTreeView cell.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

diff --git a/docs/reference/gtk/tmpl/gtkcellview.sgml b/docs/reference/gtk/tmpl/gtkcellview.sgml
index ec0072bce6b04cb42f0ee48678a5b5567c69dbb6..d324d40dc50c564baae76e511329eb00dc115d34 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkcellview.sgml
+++ b/docs/reference/gtk/tmpl/gtkcellview.sgml
@@ -6,7 +6,10 @@ A widget displaying a single row of a GtkTreeModel
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+A #GtkCellView displays a single row of a #GtkTreeModel, using
+cell renderers just like #GtkTreeView. #GtkCellView doesn't support
+some of the more complex features of #GtkTreeView, like cell editing
+and drag and drop.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -70,27 +73,6 @@ A widget displaying a single row of a GtkTreeModel
 @Returns: 
 
 
-<!-- ##### FUNCTION gtk_cell_view_set_value ##### -->
-<para>
-
-</para>
-
-@cell_view: 
-@renderer: 
-@property: 
-@value: 
-
-
-<!-- ##### FUNCTION gtk_cell_view_set_values ##### -->
-<para>
-
-</para>
-
-@cell_view: 
-@renderer: 
-@Varargs: 
-
-
 <!-- ##### FUNCTION gtk_cell_view_set_model ##### -->
 <para>
 
@@ -138,16 +120,6 @@ A widget displaying a single row of a GtkTreeModel
 @color: 
 
 
-<!-- ##### FUNCTION gtk_cell_view_set_cell_data ##### -->
-<para>
-
-</para>
-
-@cell_view: 
-<!-- # Unused Parameters # -->
-@cellview: 
-
-
 <!-- ##### FUNCTION gtk_cell_view_get_cell_renderers ##### -->
 <para>
 

diff --git a/docs/reference/gtk/tmpl/gtktreesortable.sgml b/docs/reference/gtk/tmpl/gtktreesortable.sgml
index 2c40f5b9a2b5968696192fe7f12168c57aed6c2c..546654b7efbb2d2825af7b2879149ef07d2b4c0a 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreesortable.sgml
+++ b/docs/reference/gtk/tmpl/gtktreesortable.sgml
@@ -6,12 +6,14 @@ The interface for sortable models used by GtkTreeView
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+#GtkTreeSortable is an interface to be implemented by tree models which
+support sorting. The #GtkTreeView uses the methods provided by this interface
+to sort the model.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
-
+#GtkTreeModel, #GtkTreeView
 </para>
 
 <!-- ##### STRUCT GtkTreeSortable ##### -->

diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml
index f3a127eba568f3cfd752fd19d417c6abb4ae4770..47bde21e398282ed41e3be7d7636a3b6780bf3c9 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreeview.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeview.sgml
@@ -10,6 +10,12 @@ Widget that displays any object that implements the <link
 linkend="GtkTreeModel">GtkTreeModel</link> interface.
 </para>
 
+<para>
+Please refer to the <link linkend="TreeWidget">tree widget conceptual overview</link> 
+for an overview of all the objects and data types related to the tree widget and how 
+they work together.
+</para>
+
 <!-- ##### SECTION See_Also ##### -->
 <para>
 #GtkTreeViewColumn, #GtkTreeSelection, #GtkTreeDnd, #GtkTreeMode, #GtkTreeSortable, #GtkTreeModelSort, #GtkListStore, #GtkTreeStore, #GtkCellRenderer, #GtkCellEditable, #GtkCellRendererPixbuf, #GtkCellRendererText, #GtkCellRendererToggle

diff --git a/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
index 06994f3dbfde335bb09b8f6162ff80c5b84affbd..30bbdddde55d59d644dc82972a68bf76641cee97 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
@@ -6,7 +6,15 @@ A visible column in a #GtkTreeView widget
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-The GtkTreeViewColumn object is a visible column in a #GtkTreeView widget.
+The GtkTreeViewColumn object represents a visible column in a #GtkTreeView widget.
+It allows to set properties of the column header, and functions as a holding pen for 
+the cell renderers which determine how the data in the column is displayed.
+</para>
+
+<para>
+Please refer to the <link linkend="TreeWidget">tree widget conceptual overview</link> 
+for an overview of all the objects and data types related to the tree widget and how 
+they work together.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->